home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr09 / gc4paf17.zip / GC4PAF17.DOC < prev    next >
Text File  |  1993-06-17  |  9KB  |  211 lines
  1.                ╔═════════════════════════════════╗
  2.                ║                                 ║
  3.                ║        Generation Counter       ║
  4.                ║                                 ║
  5.                ║               for               ║
  6.                ║                                 ║
  7.                ║     Personal Ancestral File     ║
  8.                ║                                 ║
  9.                ╚═════════════════════════════════╝
  10.  
  11.  
  12.      Generation Counter for Personal Ancestral File (PAF), GC4PAF, is
  13. a program that will count how many generations of ancestors,
  14. represented in a PAF database, an individual has.  Additionally, the
  15. number of ancestors in each generation will be displayed along with
  16. the percent of total ancestors for each generation they represent. 
  17. And, finally, the total number of ancestors will be displayed.  A
  18. sample of its output is
  19.  
  20.                       Taylor, James B. RIN: 35
  21.                           08 March 1993
  22.    Generation #  2 has     2 for 100.00000 percent out of     2
  23.    Generation #  3 has     4 for 100.00000 percent out of     4
  24.    Generation #  4 has     7 for  87.50000 percent out of     8
  25.    Generation #  5 has     6 for  37.50000 percent out of    16
  26.    Generation #  6 has     2 for   6.25000 percent out of    32
  27.  
  28.              Generation # 6 is the last generation.
  29.              The total number of ancestors is 21
  30.              There are no entries in generation # 7
  31.  
  32. Generation #2 is the parents of James B. Taylor.
  33. Generation #3 is the grandparents.
  34. Generation #4 is the great-grandparents.
  35. Generation #5 is the great-great-grandparents.
  36. Generation #6 is the 3rd-great-grandparents.
  37.  
  38.      Generation Counter works only with PAF databases containing
  39. INDIV2.DAT, MARR2.DAT, NAME2.DAT.  Other files of PAF are not used
  40. by GC4PAF nor are GEDCOM files.
  41.  
  42.      To use GC4PAF, you must know:
  43.  
  44.      (1)  Where the PAF database is located (C:\PAF\DATA, B:, etc.)
  45.  
  46.      (2)  The individual's Record Identification Number (RIN) or
  47.           information about the individual to search on just as
  48.           PAF does to locate individuals.
  49.  
  50. In addition, menu selection is made by selecting the menu number, use
  51. of the up and down arrow keys, or by mouse, clicking on the left
  52. button if you have a mouse.      There are two menus in GC4PAF.  The first menu asks
  53.  
  54.                   Where is the PAF database located?
  55.  
  56.                   1.  A:
  57.                   2.  B:
  58.                   3.  C:\PAF\DATA
  59.                   4.  Other
  60.  
  61. The first three choices will encompass probably 90% of the locations
  62. of PAF databases.  If your's is not one of the first three choices,
  63. then select option 4.  Just below the above menu will be displayed:
  64.  
  65.                   Location of PAF database: 
  66.  
  67. You can type in the path to the database.  The GC4PAF does NOT check
  68. this information.  If it is wrong, then you will get an error and will
  69. need to restart the program.
  70.  
  71.      The second menu asks:
  72.  
  73.                   Identify Starting Individual
  74.  
  75.                   1.  Know RIN
  76.                   2.  Do not know RIN
  77.                   3.  Help Screen
  78.                   4.  Return to System
  79.  
  80. Option 1 will ask: Which RIN?  Type in the RIN.  The RIN you have
  81. entered will be checked, the individual information displayed, and you
  82. will be asked if it's the correct individual.  If it is the correct
  83. individual, then GC4PAF will proceed to find the generations.
  84.  
  85. Option 2 allows you to find an individual's RIN by entering
  86. information about the individual and then searching the PAF database
  87. for the individual that matches the information in the positions
  88. entered.  This is similar to the way PAF finds information when the
  89. "MATCH name and position" CONFIG option is chosen.  Option 2 will
  90. display the following:                               Individual Search
  91. =====================================================================
  92. Surname:                   Given1:                   Sex:
  93. Given2:                    Given3:                   Title:
  94. ---------------------------------------------------------------------
  95. Birth date:
  96. Place1:                            Place2:
  97. Place3:                            Place4:
  98. ---------------------------------------------------------------------
  99. Christening date:
  100. Place1:                            Place2:
  101. Place3:                            Place4:
  102. ---------------------------------------------------------------------
  103. Death date:
  104. Place1:                            Place2:
  105. Place3:                            Place4:
  106. ---------------------------------------------------------------------
  107. Burial date:
  108. Place1:                            Place2:
  109. Place3:                            Place4:
  110. =====================================================================
  111.  
  112. You can enter as much or as little information you wish.  You can move
  113. around the screen using the Enter, Tab, Shift-Tab, Up and Down Arrows
  114. and end the inputting by pushing the F1 key to start the search or the
  115. F2 key to quit.  This is the same as PAF.  Names are checked when you 
  116. enter them to insure they are in the NAME2.DAT file.
  117.  
  118. Option #3 is a summary of this information.
  119.  
  120. Option #4 ends the program and returns you to the system prompt.
  121.  
  122.      GC4PAF will now display the following menu:
  123.  
  124.            What is the location of the output?
  125.  
  126.                  1.  Screen only
  127.                  2.  Printer and Screen
  128.                  3.  File and Screen
  129.                  4.  Cancel
  130.  
  131. so you can decide whether you want a printed copy or a copy sent to
  132. file.  If you choose a option 3, you will also be asked for the name
  133. of the file.  The name should include the subdirectory as well,
  134. otherwise the file will be placed in the default directory.  If you
  135. just hit the <Enter> key with nothing entered, then GC4PAF will 
  136. establish the file as PRINT.DAT in the same directory as the PAF
  137. files.  Option 4, Cancel, will result in the program returning to the
  138. second menu (Identify Starting Individual).      GC4PAF only READS and does not write to PAF files.  There should
  139. be no disruption of your PAF data files by GC4PAF.  However, it is
  140. good practice to ALWAYS have a back-up of your data whenever you use a
  141. new program and especially after you have added to or changed any
  142. information in your database.  GC4PAF will create files in the PAF
  143. database directory of the form GC0XX.LST, where XX represents the
  144. generation of ancestors, i.e., GC01.LST contains the RINs of the
  145. parents, GC02.LST contains the RINS of the grandparents, GC03.LST the
  146. great-grandparents, etc.  These files are deleted when GC4PAF is
  147. completed.  You should never see these files.
  148.  
  149. Version 1.2 has three (3) changes from version 1.1 based on comments 
  150. from Don Umberger:
  151. - Corrects an error in the search routine which prevented the program
  152.   from finding anyone.
  153. - Each generation's total possible number of ancestors is listed ("out
  154.   of      XXXX") at the end of each line.
  155. - The numbering of the generations was changed to conform to the PAF
  156.   ahnentafel system, i.e. parents are generation #2, grandparents are
  157.   generation #3, etc.
  158.  
  159. Version 1.3 has two (2) changes from version 1.2 based on comments
  160. from Don Umberger:
  161. - The RIN is displayed at the top of the display with the name of the
  162.   individual.
  163. - Added a option to print or create a file of the screen display, in
  164.   addition to the screen display.
  165.  
  166. Version 1.4 has one (1) change from version 1.3 based on comments from
  167. Don Umberger:
  168. - The user will be warned if the print to file filename already
  169.   exists.  The user will have the option to continue or not.
  170.  
  171. Version 1.5 has each generation's line moved to the left four (4)
  172. columns and four (4) additional columns given to the final column so
  173. that the totals in generations greater than 33 don't fill up the
  174. space.  This was suggested by Ed Chapman.  Released 6 Feb 1993.
  175.  
  176. Version 1.6 has two (2) changes from version 1.5 based on comments
  177. from Don Umberger:
  178. - The date when the program is run is displayed just below the
  179.   individual's name.
  180. - The total number of ancestors in the database is given.  Please note
  181.   that the number of ancestors will include any duplicates as the
  182.   result of cousins marrying cousins.
  183. - In addition to the two above changes, option 4 of the location of
  184.   output menu has been changed, so that you are returned to the second
  185.   menu (Identify Starting Indiviudal) rather than just printing to the
  186.   screen.
  187. Released 8 March 1993.
  188.  
  189. Version 1.7 has two changes from version 1.6
  190. - The program will work with monochrome monitors (earlier version
  191.   wouldn't).
  192. - The mouse capability of the menus was removed.
  193. Released 17 April 1993.
  194.  
  195. Personal Ancestral File and PAF are registered trademarks of the
  196. Corporation of the President of The Church of Jesus Christ of
  197. Latter-Day Saints.
  198.  
  199.      All rights to GC4PAF and its accompanying files are reserved. 
  200. GC4PAF may be distributed and used only for non-profit purposes. 
  201. Comments, problem reports and sugggestions for improvements are
  202. welcomed and may be sent to:
  203.  
  204. Address:       Frank E. Hutchison
  205.                Qtrs D, Mason Row
  206.                Yorktown, VA 23690
  207.  
  208. Phone:         (804)887-0290 between 6:00 and 9:00 pm Eastern
  209.  
  210. I also monitor the GENSOFT echo for messages to Frank Hutchison. 
  211. Please note the spelling of the last name.